Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working with Movie Time

SetMovieTime

The SetMovieTime function allows your application to change a movie's current time. You must specify the new time in a time structure. The Movie Toolbox saves the movie's current time when you save the movie.

pascal void SetMovieTime (Movie theMovie, 
                           const TimeRecord *newTime);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

newTime

Contains a pointer to a time structure. If you specify a value that is outside the duration of the movie, the Movie Toolbox sets the movie time to the beginning or end of the movie, as appropriate.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can use the SetMovieTimeValue function, described in the previous section, to change a movie's current time without specifying a time structure.

You can retrieve a movie's current time value by calling the GetMovieTime function, which is described in the next section.